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An Overview 


Cromemco's new Multi-User BASIC Operating System 
includes features which are usually found only on 
large computers. It is composed of a time-sharing 
operating system, Multi-User CDOS, and an enhanced 
version of Cromemco 16K Extended BASIC. The 
hardware configuration required for the operation 
of the Multi-User BASIC Software System is shown in 
chapter 11 of this manual. 


The current version includes many new features. 
Users are no longer restricted to running BASIC. 
One user can run the assembler, for example, while 
another is running the FORTRAN compiler, and a 
third is running BASIC. 


The new version allows users to start several jobs 
from the same terminal by using the Multi-User CDOS 
command, DETACH. Other new CDOS commands are: 

- ATTACH retrieves a DETACHed job. 


- BACKG allows a job to be run in the background. 


- BAS loads and runs BASIC. 

- CHA is the command entered in order to change 
diskettes. 

- KILL allows jobs to be terminated from 


selected terminals. 


- LOGOFF allows users to terminate their sessions. 


- MORE allows users to obtain larger memory 
allocations. 
- PRT: allows the users to access either a 


dot-matrix. or fully formed character 
printer with CTRL-P. 


~ RESCUE allows users to initialize disabled 
terminals. 
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- SET allows the user of terminal-l to set the 
time, date, and adjust the clock rate. 
Each user may set the number of nulls 
after each RETURN, an automatic line feed 
after each RETURN, and a user-selected 
ERASE character. 


- sys displays for all users: job number, 
Status (busy or wait), whether BASIC is 
loaded, which CDOS program is running, 
how much memory is allocated, terminal 
number and user name, and the time that 
user logged on. 


- TIME displays the current time and date. 

Since Multi~User CDOS buffers input from the 
terminal keyboards, users can enter characters 
before the executing program requests them. This 


feature, commonly known as "“type-ahead", is often 
very convenient to use. 


Multi-User BASIC includes the following attributes 
in addition to those of 16K Extended BASIC: 

- an in line BASIC text editor 

~ upper and lower case program text 

- variable names up to 31 characters long 


- line and subroutine names up to 31 characters 
long 


~ many new statements and commands such as 


‘- PROTECT which insures that a file cannot be 
read from, written to, or erased 


- IF...THEN DO...ELSE...ENDDO 

- COMMON for linking BASIC programs 

- LVAR which lists the variables, functions, 
and label names of the program together with 


their current values 


- NOLIST and DELREM which can be used to 
protect proprietary SAVEd. BASIC programs 


io ee 
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Getting Started 


Turn on the. terminals, disk drives, and computer. 
Set each of the terminals to 9686, 480898, 24090, 
1208, 308, 158, or 118 baud. The terminals need 
not all be set the same. Place the Multi-User 
System diskette.in Disk Drive A. Depress the 
RETURN key on terminal-1l several times. 


Prompts will be issued for the name of the user, 
the date, and the time. 


After the time is set, the following prompt is 
issued: 


Place diskette in Drive A and press any key 


This provides the option of exchanging the disk in 
Drive A before going on. 


Prompts are then issued to determine whether or not 
diskettes are loaded into the remaining drives in 
the system. All files left open on the diskettes 
-in any of the drives will .be closed. This provides 
a way to rectify the situation when the computer is 
inadvertently reset with files open. 


Additional users may then log on the other 
terminals. 


Log-on for each of these users is accomplished by 
pushing RETURN several times so that the operating 
system can detect the baud rate of the terminal. A. 
prompt will then be issued for the user's name. 


Write-protecting diskettes is not necessary with 
Multi-User BASIC. Write-protected diskettes are 
those 8" disks with a notch exposed and those 5" 

' disks with the notch covered. There is a facility 
for write-protecting files instead. See the 
PROTECT command. 


Backup 


It is strongly recommended that a backup disk be 
made. immediately upon receiving your FDM. software 
package. 
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User Protection 
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Multi-User BASIC provides several different kinds 
of protection for users. 


Directory Protection 


The operating system maintains directories which 
contain information. about the files stored on the 
disks. In order to protect this information, locks 
are provided in the operating system to insure that 
a user can complete certain kinds of directory 
accesses, once begun, before another user can begin 
one. 


For example, suppose that after BASIC has begun to 
execute a CLOSE file statement for a user, the 
operating system interrupts and switches to a 
second user. If the second user then attempts to 
execute a RENAME file statement, the operating 
system will cancel the turn and not allow further 
execution time until the CLOSE statement has been 
completed for the first user. 


Protection of File Integrity 


There are two different senses in which files can 
be safeguarded. Multi-User BASIC has the PROTECT 
command which can be used to specify that ‘a file 
cannot be erased, written to, or read from. This 
helps to preserve files from inadvertant misuse. 


There is another way in which files need. to be 
protected in multi-user systems which allow more 
than one user to write to the same file. 


Suppose that two users access a file storing charge 
account: information for a retail store in the 
following sequence. 


User-l reads the record for account no. 399 
and user-2 also reads the same’ record. 


User-l adds a new charge to the account and 
writes the record back to the file. 


User-2 makes a correction to the address field 
of the account and updates the file. 
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The result is that the charge data that user-1 
added to the record is lost because it has been 
over-written by user-2. This is called the mutual 
exclusion problem. 


What is needed is a way to restrict access to 
files. This is provided by the OPEN statement. A 
file can be opened by a user in several ways: 


(W) exclusive permission to write to the 
file, but non-exclusive permission to 
read from it, 

(X) exclusive permission to read and write, 

(N) a guarantee that no user will write to 
the file, and non-exclusive permission 
to read, or 

(R) non-exclusive permission to read the 
file. 


The solution to the problem illustrated by the 
example above is automatic since there is no way 
for two people to simultaneously have the same file 
open for writing. 


This, however, can present another problem. One 
user can have a file open for writing for a long 
time, locking all others out. A way to minimize 
this problem is to write the BASIC program so that 
the file is opened only for reading (R) while the 
user is searching through it. When the user is 
actually ready to update the file, the BASIC 
program should open it for reading and writing (W 
or X) just long enough to re-read the record that 
is to be altered (to insure that current data is 
being acted upon) and to write the corrected record 
back to the file. 


In cases where records refer to each other so that 
updating one record requires updating the other, 
the file must be’open for reading and writing long 
enough to re-read and update both records. 


Protection from Deadlock 
When a data base includes more than one file, 


records in one file may refer to records in another 
file in the data base. 
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In this case, updating a record in one file may 
‘require updating records in other files also. 
Therefore, when a user is ready to update a record, 
the BASIC program should open all the files in the 
data base for reading and writing (Wor X) just 
long enough to re-read the record and relevant 
cross-referenced records and to update them. 


This introduces the potential for a new problem, 
however. Suppose that user-l has file-l open for 
writing and user-2 has file-2 open for writing, but 
both users need both files open for writing to 
complete the current operation. This is a 
deadlock. Neither user can proceed. 


Multi-User BASIC has a feature which can be used to 
avoid this dilemma. If a BASIC program 
concatenates a series of statements from the 
following list, then the directory will be locked 
from the time the first statement in the series 
begins execution until a statement which is not in 
the list occurs. 


OPEN 
CLOSE 
CREATE 
PROTECT 
ERASE 


This means that after a user has opened the first 
file in a list of consecutive files, no other user 
can open a file further down in the list even if 
the operating system interrupts and switches to 
another user. 


Deadlock will not occur if the BASIC program 
includes code such as the following to handle the 
opening of the data base. We assume that the data 
base includes files named "file-1", "file-2", and 
"file-3". 
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1@ Integer False, True, Try'again, Error'number 
20 False=9 
30 True=Not False 


1908 *Open'data'base 

1918 On Error Goto Data'base'in'use 

18028 Open \l\ “file-1", "w" 

103@ Open \2\ "file-2", "Ww" 

1848 Open \3\ "file-3", "Ww" 

1845 Rem DO NOT INTERSPERSE ANY STATEMENT 
1858 Rem AMONG THE THREE LINES ABOVE. 

1869 Rem IF WE HAVE REACHED THIS POINT, THEN WE HAVE 
1878 Rem SUCCEEDED IN OPENING ALL THE FILES 
1989 Rem IN THE DATA BASE. 

1098 Rem RESTORE THE NORMAL ERROR HANDLER. 
110@ On Error Goto Normal'error'handler 


1290 *Data'base'in'use 
1295 Rem IT IS IMPERATIVE THAT WE TRY TO CLOSE 
1218 Rem ALL FILES IN THE DATA BASE, EVEN THOUGH 
1228 Rem SOME MAY NOT HAVE BEEN OPENED 
1239 Rem AT THE TIME THE ERROR OCCURRED. 
1235 Rem TEMPORARILY MAKE DO'NOTHING, WHICH DOES 
124@ Rem NOTHING AT ALL, THE ERROR HANDLER, 
125@ Error'number = Sys(3) 
1260 On Error Gosub Do'nothing 
1278 Close \1\ 
1288 Close \2\ 
1298 Close \3\ 
1398 Rem RESTORE THE ERROR HANDLER 
1318 On Error Goto Normal'error'handler 
1328 Rem UNLESS THE ERROR WAS 224 
1338 Rem (FILE BUSY), DO NOT TRY AGAIN. 
- 1348 Try'again = False 
135@ If Error'number = 224 Then Do 
°135@ Input"Data Base busy. Try again? ",Reply$ 
1368 If Reply$(9,8)="y"Then Try'again=True 
1365 If Reply$(9,%9)="Y"Then Try'again=True 
1378 Enddo 
1388 If Try'again=True Then Goto Open'data' base 


1598 *Do'nothing. 
1518 Return 
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Description of the Operating System 


198 


Multi-User BASIC Instruction Manual 
Operating System Description 


Description of the Operating System 


The operating system has control of the computer. 
When a user logs on, the operating system finds an 
empty bank of memory and then enters the user into 
the active queue. The users in this queue take 
turns executing their programs. Each turn is on 
the order of tens of milliseconds duration. 
However, if a user requests input or output which 
is not ready, the operating system terminates the 
user's current turn and does. not grant another turn 
until the input or output is ready. 


Terminal input and output are serviced by means of 
interrupts. When a key is pushed on the user's 
keyboard, the current process in execution is 
interrupted long enough for the operating system to 
get the character and put it into the user's 
terminal buffer. If blocked awaiting this input, 
the user would take a place in the active queue. 
When a turn comes around again, the user's program 
can then fetch the character from the buffer. 
Terminal output is handled in a similar manner. 


Another function of the operating system is to 
coordinate requests for input from and output to 
the disks. When a user makes such a request, it is 
placed into the disk I/O queue, and the user is 
blocked until the request has been serviced. 


The requests in the disk queue are ordered by disk 


and by track. This minimizes the motion of the 
disk heads required to service the users. 
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Attributes of Multi-User CDOS 
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Type-ahead 


Since Multi-User CDOS buffers input from the 
terminal keyboards, users can enter characters 
before the executing program requests them. This 
feature, commonly known as "“type-ahead", is often 
helpful. When using the Screen Editor, for 
example, one can insert a string of characters and 
then begin to delete some characters following the 
string without having to first wait for the screen 
to be updated. F 


In case of error, typing CTRL-U will discard all 
the characters which have not already been utilized 
by the executing program. 


There is a second way of entering characters at the 
keyboard before the executing program requires 
them. CDOS and many programs which run under CDOS 
accept keyboard input one line at a time. The user 
types the characters of the line and then 
terminates the line with a carriage return. In 
Multi-User CDOS, the linefeed key may be used 
instead of the carriage return key to separate 
different input lines sent to the program. The 
linefeed is transformed into a carriage return when 
it is sent to the executing program. However, none 
of the characters are sent to the program until an 
actual carriage return is typed. For example, one 
could enter the following line followed by a 
carriage return. 


ERA *.BAK|BATCH|STAT|IASMB TESTFILE.ABZ| 


Note that each linefeed is echoed to the terminal 
screen as a vertical bar "|". After the carriage 


return is typed, each string of characters followed ~ 


by a carriage return is sent to CDOS or the 
executing program as a separate line. When the 
program receives the line, the line is echoed 
again. In the current example, the user would then 
see (assuming we are using disk drive A): 


A.ERA *.BAK 

A. BATCH 

Batch version 09.85 
~STAT 

~ASMB TESTPILE.ABZ 
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CDOS Call To Display Job Information 


The new CDOS system call QODFH will return the job 
number, terminal number and name of the current 
user. To use it call 69995 with ODFH in the C- 
register. The current job number will be returned 
in the C-register and the terminal number in the B- 
register. These will be encoded in ASCII. If the 
job is detached, there will be no terminal number 
and an asterisk will be returned in the B-register. 
The DE-register containing the address of the user 
name in memory. The last character of the name is 
marked by having its parity bit set. 
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Multi-User CDOS Commands 
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command: BACKG 


This command can be used to place a job in the 
background. A background job will only run when 
all jobs not in the background are waiting for 
input or output. 


BATCH is a CDOS program which is, for all practical 
purposes, the same as the @ command described in 
the CDOS instruction manual. A job can be placed 
in the background by executing a BATCH file which 
includes the BACKG command.as one of its lines. If 
this is done, then all of the commands which follow 
the BACKG command in the BATCH file will run in the 
background. If the command on the last line in the 
BATCH file completes execution and return is made 
to CDOS, the foreground mode of operation resumes. 


For example, entering the following three lines 
will cause BASIC to run in the background in the 
current job until return is made to CDOS by means 
of the BASIC command BYE. 


A.BATCH 
!BACKG 
!BAS SORT.SAV 


In the above, "A." is the CDOS prompt and "!" is 
the BATCH prompt. 
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command: BASic 
format: BAS 
BAS [file-ref] 


where: 
file~ref is the name of a SAVEd file 


The BAS command allows the user to enter BASIC and 
load and execute a SAVEd BASIC program if desired. 


The request to load and execute a BASIC program 
will be honored upon the user's first entry into 
BASIC by means of the BAS command. The user may 
exit BASIC, run CDOS commands only, then return to 
BASIC via the BAS Command. Upon re-entering BASIC 
in this fashion, the previously executed SAVEd 
program will still be in memory. If the user runs 
CDOS programs after leaving BASIC, the previously 
executed SAVEd program will not remain in memory. 





The user will enter BASIC immediately if it has 
already been loaded. If BASIC has not been loaded 
and no one is using the memory space in which it 
resides BASIC will be loaded. The user will be 
informed: 


Loading BASIC. 
Otherwise, the user will be informed: 


BASIC unavailable. 


Le 
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command: CHA 


To change a diskette, type CHA followed by a 
carriage return. After the following prompt: 


Disk Drive (A,B,C,D)? 

enter the drive letter. 
If there are files open on the drive, the user will 
be informed which users have opened them. The 
diskette should NOT be changed. 
If there are no files open on the drive, and the 
diskette is in Drive A, the user will be 
instructed: 

Place diskette in Drive A and press any key. 
(The operating system requires a diskette in Drive 
A.) If the diskette is in any of the other drives, 
for example Drive B, the user will be asked: 

Is there a diskette in Drive B (Y,N)? 


Answer in the negative if the drive is to be left 
empty. 


This command may be restricted to the users of 
selected terminals. For further information see 
the section on Modification of Multi-User BASIC. 


18 


Multi-User BASIC Instruction Manual 
Multi-User CDOS Commands 


command: DETACH 


This command can be used to execute several jobs 
from a single terminal. A user can start a new job 
by executing a BATCH file which contains the DETACH 
command as one of its lines. (BATCH is a CDOS 
program.) When the DETACH command is executed, two 
things happen: 


l. a. The execution of the subsequent lines in the 
BATCH file continues for the current job. 


b. The current job is detached from the user's 
terminal. This means that any terminal 
output is discarded, and if any terminal 
input is requested, the job waits until the 
it is again connected to the user's terminal 
by execution of the ATTACH command. 


c. If the command on the last line in the BATCH 
file completes execution and return is made 
to CDOS, the job is terminated. 


2. a. A new job is started for the user with a new 
job number. 


b. The users's terminal is attached to the new 
job. The CDOS prompt is issued to the 
terminal screen and the user can enter 


commands from the keyboard to be executed 
under the new job number. 


For example, entering the first three lines 
following will cause the current job to assemble 


the file PRODUCT.Z88 located on Drive A and to 
place the output files on Drive B. Meanwhile the 
user will be given the CDOS prompt for entering 
other commands under a new job. 


A.BATCH 
! DETACH 
!ASMB PRODUCT.ABB 
A. 
In the above, the first CDOS prompt "A." and the 


BATCH prompts "!" are issued under the old job. 
The last CDOS prompt is issued under the new job. 


LQ 
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The following is the same as the last example 
except that the current job will run in the 
background and it will include the running of the 


BASIC program ANALYSIS.SAV after the assembly is 
finished. 


A. BATCH 

!DETACH 

!BACKG 

{ASMB PRODUCT.ABB 
!BAS ANALYSIS.SAV 


A. 
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command: ATTACH 


To retrieve a DETACHed job, type ATTACH followed by 
a RETURN. Enter the number of the job after the 
following prompt is issued: 


Job number (1,...,7)? 


If the requested job is a DETACHed job that the 
user previously started, the user's current job 
will be.terminated and the user's terminal will be 
re-~ATTACHed to the requested job. Otherwise, the 
user will continue running the current job. 


ZL 
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command: KILL 


To terminate a job, type KILL followed by a 
carriage return. After the following prompt enter 
the job number: 


Job number (1,...,7; CR)? 


The numbers of all current jobs can be determined 
by using the SYS command. To avoid executing the 
KILL command, press the carriage return only. 


This command should be used with caution on a job 
which has files open for writing. Such files will 
be closed before the job is terminated and the last 
data that was written to the file may be lost. 


This command can be restricted to the users of 


specified terminals. See the Modification of 
Multi-User BASIC section. 
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command: LOGOFF 


The LOGOFF command may be used by any user to log 
off that user's job. 
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command: MORE 


To obtain more memory, type MORE followed by a 
carriage return. If enough memory is available, 
the user will be assigned 48K and informed: 


48,887 bytes obtained. 
Otherwise, the user is informed: 
Extra memory unavailable. 


If no other memory is available and nobody is 
running BASIC, then the memory space between 8999 
Hex and C@9@ Hex in which BASIC resides will be 
assigned to the first user who requests MORE 
memory. Until this user gives up the extra space 
by entering the LOGOFF command or the BASic 
command, any other user who shares the common BASIC 
memory at 8990 Hex with the first user, and who 
tries to load BASIC, will be informed: 


BASIC unavailable. 


It is possible to configure the system so that many 
users can simultaneously have extra memory. For 
details see the Special Configuration portion of 
the Hardware chapter. With this system 
configuration a user can load BASIC regardless of 
whether others users have obtained 48K of memory, 


A user who has obtained 48K of memory using the 
MORE command can, if nobody is running BASIC, get 
still more memory by entering the MORE command a 
second time. This is the memory which BASIC uses 
above C@@G Hex. If successful, the user will be 
informed: 


54,263 bytes obtained. 


Until this user gives up the space by entering 
LOGOFF or BAS, no other user can load BASIC, even 
with the special system configuration. Two 
requests for MORE memory are required to get this 
maximum amount of memory in order to limit its use 
to those who need it. 


The second and first uses of the MORE command may 
be restricted to the users of selected terminals. 
See the section on Modification of Multi-User 
BASIC. ; 
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command: PRT: 


In Multi-User CDOS the printer may be treated as if 
-it were a file. Therefore anything that can be 
written to a file can also be written to the 
printer. Cromemco dot matrix printers (models 3793 
and 3779) may be referenced by "par:". For 
example, the BASIC command 


List. "par2* 


would list the current BASIC program to the 
printer, and the BASIC command 


lvar "par:" 
would list the program's. variables to the printer. 


The CTRL-P key may also be used to send output to 
the printer. 


If one person is using a printer, anybody else who 
tries to access the printer is informed that the 
device is busy (in BASIC, error 224 is returned). 


When running BASIC the printer may also be opened 
as a file so that data can be output to it by means 
of the PUT or PRINT commands. The following 
subroutine would output the contents of the string, 
Error'message$, to the printer: 
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500 *Error'routine 

518 Open\l\"prt:" 

52@ Print\l\ 

536 Print\l\ Error'message$ 
54@ Print\l\ 

55@ Close\l\ 

560 Return 
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‘command: RESCUE 
To initialize all terminals which were turned off 


when the operating system was loaded, type RESCUE 
followed by a carriage return. 
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command: SET 


The SET command is used to set various parameters. 
The clock can be adjusted and the date and time set 
by the user of the System Console. All users can 
use the SET command to select their alternate erase 
key, the number of nulls appended to each output of 
the carriage RETURN, and whether a line feed is 
automatically appended to each output of a RETURN. 
To use this command, type SET followed by a RETURN. 
The following will be displayed: 


Clock rate 
Date 

Erase 
Linefeed 
Nulls 

Time 


OM &WhH eH 


Enter number of desired function (1,...,6): 


After the function number is typed a prompt will be 
issued, dependent upon the function, for the 
desired parameter change. To change the parameter, 
type the new value. To leave the parameter 
unchanged, type only a RETURN. 


Notes: 


1. The Clock Rate may be adjusted by entering 1 
as the function number. The system will 
respond: 


Faster or Slower (F,S)? 


Type F for a faster or S for a slower clock 
rate. 


26 The Date may be SET by entering 2 as the 
function number. The system will respond with 
three queries: 


Year (1979,...)? 
)? 


Month (l,...12 
Day(1l,...31)? 


28 


Multi-User 
Multi-User 


BASIC Instruction Manual 
CDOS Commands 


Two Erase keys are provided. One is the 
DELete key. The other Erase key is, by 
default, the underscore key. This can be 
changed to suit the user by entering 3 as the 
function number. The system will respond: 


Press the desired Erase key: 


Enter the desired alternate Erase character, 
followed by a RETURN. The DELete key will 
still function as an.Erase character. Users 
of 3192 terminals will probably want to change 
the underscore key to the back-arrow key. 


A line feed may be added after each output of 
a carriage return by first entering 4 as the 
function number. The system will respond: 


Automatic LF after CRs (Y,N)? 
Enter Y to enable the added linefeed function. 
Nulls are needed following carriage returns in 
some terminals. To set the number of nulls, 
type 5 as the function number. The system 
will respond: 

Number of Nulls after CRs (@,...,127)? 
Enter the number of nulls needed. 
To SET the time, type 6 as the function 
number. The system will respond with three 
queries: 

Hour (1,...,12)? 


AM or PM (A,P)? 
Minute (@,...,59)? 
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command: SYS 


Type SYS to display the following data for all 
users who are logged on: 


- job number 

~ job status: WAIT if waiting for input or 
output, BACKG if running in the background, or 
RUN if running in the foreground 


- load: BAS if BASIC is loaded in the job's 
memory at 80@@0H, otherwise the field is blank 


- program: the name of the CDOS program which 
the job is running; the field is blank if no 
CDOS program is running 


~- memory: the number of bytes in the job's 
memory space 


- terminal number and name of the user who owns 
the job; an asterisk appears in place of the 
terminal number if the job is detached 


- time that the user logged on the job 


SYS displays a report similar to the following: 


ey ee ee ae ay ee eee ee ee ee ee ee er ne ee ee Se Sy DD Se De ee ee ee Oe Se PE SED AE Ee He HD WD SU RD UD em ED Gem ee YO ED SO SN CD 


| Job | Stat | Load | Program | Memory | Terminal, User | Logon | 
| 12 | Run | | 54,263 | 1 Joe | 98:25A | 
} 2 | wait | | 48,887 | 2 Mike | 98:30A | 


This report will update once every two seconds. To 
terminate the SYS command, press any key (the space 
bar or the RETURN key are preferable). 
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command: TIME 


The TIME command is used to display the current 
date and time. This information is derived from a 
software clock which is driven by an interrupting 
timer. It has limited accuracy. However, it can 
be set and adjusted using the SET command. 
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Multi~User BASIC Names 
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Format of Numeric Variables 


A variable name includes from 1 to 31 characters. 
The first character must be alphabetic. Each of 
the remaining characters may be alphabetic, 
numeric, or the apostrophe ('). 


Variable names may be entered in upper or lower 
case characters, or any combination of the two. 
BASIC will convert the variable name into its own 
format, which is an initial upper case character 
followed by all lower case characters. 


The following are examples of legal variable names: 


Interest'rate 

AO 

A123 

Namels 
Price'to'earnings' ratio 


Note that the $ character above is not one of the 


normal characters of the name, but is a suffix 
which BASIC uses to indicate strings. 
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Line Names 


A statement line may be referenced either by a line 
number or by an alphanumeric line name. A line. 
name includes from 1 to 31 characters. The first 
character must be alphabetic. Each of the 
remaining characters may be alphabetic, numeric, or 
the apostrophe ('). 


A line is labeled with a line name by following the 
line number with an asterisk and then the line 
name. The asterisk and name is considered an 
instruction which declares the name of the line. 
The line may contain additional instructions 
separated by colons as specified by BASIC syntax. 


Label names are used with Goto and Gosub to 
transfer control from one part of a program. to 
another. They may also be used to reference 
various parts of a program for Editing, statement 
Renumbering, etc. 


Example: 


18 *Beginning 


58 Gosub Get'data 
6@ Gosub Process'l9 


98 Goto Beginning 


300 *Get'data : Data'pointer=1 


369 Return 
400 *Process'l9 : Error'flag=9 


459 Return 
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Multi-User BASIC Commands 
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instruction: CLEAR 
format: [Ln] CLEAR 


wheres: 


Ln is an optional line number. 


Tf ba .is. tneluded,;, the 
instruction is executed at run 


time. Otherwise, it is executed 
immediatély. 


The CLEAR instruction recovers as much space as it 
can from deleted lines. 


Notes: 


1. 


This instruction is most useful when, upon 
entering a program, the user receives a space 
overflow message. It can be entered at this 
point while no other instruction can be used. 


CLEAR can also be used after using DELETE and 
ENTER instructions when performing an overlay, 
to recover space not needed by the new 
overlay. , 


CLEAR recovers only part of the available 
space. For maximum space recovery use the 


following sequence: 


a. LIST the program to a disk file 
b. SCRatch the user area 

c. ReENTER the program. 

d. SAVE. the program. 
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statement: COMMON storage area 
format: Ln COMMON 


where: 
Ln is a line number. 


The COMMON statement may be used when chaining from 
programs using RUN statements. 


This statement reserves an area for variable 
storage. The size and contents of this area are 
determined by the string variables and array 
variables which have been explicitly DIMensioned 
since the last Run instruction or since BASIC was 
loaded. The space is reserved in a byte-by-byte 
fashon without regard to variable type or length. 


A subsequent RUN instruction will initialize all 
variables except those in the reserved area. The 
reserved area will be assigned on a byte-by-byte 
basis to variables as they are DIMensioned in the 
chained-to program. 


The reserved area will cease to be reserved if two 
RUN instructions are issued without an intervening 
COMMON instruction. 


Note: 


l. It is the responsibility of the user to ensure 

- that DIMensioned variable types match between 

programs. For example, if program A is as 
follows: 


290 Dim Name$(25), Interest‘ rate(19,2) 
368 Integer Time' period(1@@) 

488 Common 

588 Run "B" 


then program B, if it has explicitly 
DIMensioned variables, must DIMension: 
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a. 26 bytes of string (ASCII) variables 


b. 264 bytes of long floating point 
variables (9 through 19 by @ through 2 at 
8 bytes for each long floating point 
number) 


Cs 202 bytes of INTEGER variables (@ through 
199 at 2 bytes each) 


in that order. The names and lengths of the 
strings and arrays do not matter, as long as 
the types match. For example, program B might 
use either of. the following sets of 
statements: 


Xe 19 Dim Title$ (9) ,Reference$ (15) ,Table(1@,2) 
2@ Integer Time'prior(25) ,Time'current (24) 
30 Integer Time' future(49) 
48 Common 


Ye 19 DIM Last'name$ (1),First'name$(1),Middle' name$ (1) 
28 Dim Initials$ (19), Value(1@,2) 
3@ Integer Buffer (108) 
48 Common 


Notice that the 27th through 290th bytes in 
the reserved area must be dimensioned 
similarly in each program if the same indices 
are to be used in each program. This is true 
for all two and three dimensional arrays. 
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command: DELete REMark statements 
format: DELREM 
DELREM Ll 
DELREM Ll, 
DELREM L1,L2 


where: 
Ll is an optional line number or 
line name. 


If Ll is omitted, all lines of 
the program are processed. 


If Ll is the only argument and 
there is no comma following it, 
then Ll is the only line 
processed. 


If Ll is the only argument and 
the comma is included, Ll 
through the last line in the 
program are processed by the 
command. 


L2 is an optional line number or 
line name which indicates the 
last line to be processed. If 
included, it must be preceded by 
Ll and a comma. 


The DELREM command deletes all REMark statements 
which occur in the lines specified by Ll and L2. 


‘Notes: 


1s The deletion of REMark statements from a 
program will reduce the amount of memory space 
needed to run it and disk space needed to 
store it. However, it will have virtually no 
effect on the execution time of the program. 


ag 
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Because deleted REMark statements are not 
recoverable,: the following procedure is 
recommended for the use of DELREM: 


Qe 


After a program has been debugged, LIST 
or SAVE a copy of the program to a disk 
file before using DELREM. 





Use DELREM to delete REMark statements. 


Save a copy of the new, shorter version 
of the program in a different file. The 
file extension NSV could be used to 
indicate "No remarks, SaVed file". 
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instruction: EXPAND 
format: [Ln] EXPAND str-var[(aexp-1),] aexp-2 
where: 

Ln is an optional line number. 
If Ln is included, the 
instruction is executed at run 
time. Otherwise, it is executed 
immediately. 


str-var is a required string variable. 


aexp-l1 is an optional arithmetic 
expression. 


The default value for aexp-1l is 


0. 
aexp~2 is a required arithmetic 
expression 


The EXPAND instruction inserts null characters into 
a String variable. 


Notes: 


1. The number of nulls to be inserted is 
specified by aexp-2. The nulls are inserted 
before the character specified by aexp-l. 


2. Remember that the first character in a string 
is located at index position @. 


3. This instruction is very useful for inserting 
characters into the middle of a string. 


Example: 


196 AS = "ABEF" 
118 EXPAND A$ (2) ,2 
129 A$(2,3) = "CD" 
13@ PRINT AS 

RUN 

ABCDEF 
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statement: IF...THEN...DO...ELSE 


format: Ln IF exp THEN DO [:program instruction(s)] 


{program instruction(s) ] 


[Ln ELSE [:program instruction(s)]] 


[program instruction(s)] 


e 


Ln ENDDO 
where: 
Ln are line numbers 
exp is a relational or arithmetic 
expression. 


If exp evaluates to true (not equal to zero), then 
the program instructions following DO are executed. 
If, in addition, ELSE is coded, ELSE will transfer 
control to the ENDDO statement. 


If exp evaluates to false (equal to zero), then 
control is transferred to ELSE (if ELSE is used) or 
to ENDDO (if ELSE is not used). 


Example: 


The following program will request a line of text 
from the user, and then count the number of words 
and non-blank characters in that line. The average 
number of characters per word will be computed and 
displayed and then the user will be prompted for 
another line of text. Entering a RETURN in 
response to the request for input will terminate 
the program. 
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19@ 
116 
128 
138 


148 | 


1508 
168 
176 
186 
1998 
260 
218 
2208 
230 
248 
258 
2698 
2798 
288 
296 
398 
318 
328 
338 
346 
358 
368 
3798 
389 
396 
498 
416 
4208 
43 
449 
458 
469 
476 
489 
496 
508 
519 


Dim BufferS$ (190) 
Dim Blank$(@) : Blank$=" " 
Rem Initialize blank character flag 
Rem word counter 
Rem character counter 
Last'char'was' blank=6 
Number'of'words=1 
Number'of'char=6 
Rem Prompt user 
Input"Enter line of text: ",Buffers 
Rem Check for user termination (null buffer) 
Length' of' buffer=Len(Buffer$S) 
If Length'of'buffer=@8 Then,goto 519 
Rem 
Rem 
Rem Loop through buffer 
For Index=@ To Length'of'buffer-l 
Rem Check for blank character . 
If BufferS$ (Index,-1)=Blank$ Then Do 
Rem Check if the last character was a blank 
If Last'char'was'blank=8 Then Do 
Rem If not, increment word counter and 
Rem set flag 
Number'of'words=Number'of'wordstl 
Last'char'was'blank=1 
Enddo 
Rem If not a blank, increment character counter 
Rem and reset flag 
Else 
Number 'of'char=Number'of'char+l 
Last'char'was'blank=@ 
Enddo 
Next Index 
Rem 
Rem 
Rem Display results and return for another user entry 
@"Number of non-blank characters is ";Number'of'char 
@"Number of words is ";Number'of'words 
Avg=Number'of'char/Number'of'words 
@"Average number of characters per word is “;Avg 
Goto 158 
End 


43 


— 


Multi-User BASIC Instruction Manual 
Additional Commands to 16K BASIC 


instruction: List VARiables 


format: {Ln} LVAR 


{Ln] LVAR file-ref 


where: 
Ln is an optional line number. 
If Ln is ineluded, the 
instruction is executed at run 
time. Otherwise it is executed 
immediately. 
file-ref is an optional string variable 
or string literal file-reference 
denoting the destination of the 
list of variables. 
If omitted, the listing is 
displayed on the console. 
The LVAR instruction lists all variables, 


functions, procedures, and alphanumeric line names. 
The abbreviations used in the list are: 


The 


INT integer variable 

SFP short floating point variable 
LFP long floating point variable 
LBL alphanumeric label, line name 
FUN function name 

PROC procedure name 

$ string variable 

(*) list or matrix 


current value of each scalar arithmetic 


variable is also displayed. 


Notes: 


mie 


Tf a variable, function, procedure name or 
line name is used in a BASIC program, and then 
the line containing that item is deleted, the 
item will still appear in the list produced by 
LVAR. The list can be updated by LISTing the 
program to a file, SCRatching the User Area, 
ENTERing the program, and then using LVAR. 
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If a line name, procedure name, or function 
has been defined in the program, its line 
number will be printed after its type. [If a 
line name, procedure name, or function has 
been used (e.g., Goto Start'over) but not yet 
defined, no entry will follow the type. 
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command: NOLIST 
format-l: NOLIST 
format-2: NOLIST Ll 
format-3: NOLIST Ll, 


format-4: NOLIST L1,L2 


where: 

Ll is an optional line number or 
label name. 
If Ll is omitted, all lines of 
the program are processed. 
If Ll is the only argument and 
the comma is missing, then Ll is 
the only line processed. If Ll 
is the only argument and the 
comma is included, Ll through the 
last line in the program are 
processed by the instruction. 

L2 is an optional line number or 


label name. 


L2 indicates the last line-to be 
processed. It must be preceded 


by Ll and a comma. 


The NOLIST command allows the programmer the option 
of keeping part or all of a BASIC file 
confidential. After the execution of the NOLIST 
command, lines Ll through L2 cannot ever be listed. 


Notes: 


l. Note that both line numbers and alphanumeric 


label names are considered label names. 
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Because NOLISTed lines can never be listed, 
the following procedure is recommended for the 
use of NOLIST: 


a. After a program has been debugged, SAVE or 
LIST a copy of the program to a disk file 
before uSing NOLIST. 


b. Use NOLIST to protect those parts of the 
' - program which are confidential. 


c. SAVE a copy of the NOLISTed version of the 
program in a different file. (One could 
use the file extension "PUB" to indicate 
that it is a PUBlic file.) 


This command protects only those lines present 
at the time the command is executed. If, 
after the NOLIST command has been executed; 
new lines are entered, they will not be 
protected from listing even if they replace 
already NOLISTed lines. 
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instruction: OPEN file 


format: [Ln] OPEN\£[,r,t]\svar-l[,svar-2] 


is an optional line number. 


PvE Ln is included, the 
instruction is executed at run 


time. Otherwise, it is executed 


is an arithmetic expression. 


f specifies the file channel 
number selected by the user. The 
value of f£ ranges from one to a 
maximum which is installation 
dependent. The number is used to 
identify the file elsewhere in 


is an optional arithmetic 


r specifies the file record size. 
The value of r ranges from 1 to 
32767. Its default value is 128. 
is an optional arithmetic 
t specifies how the file may be 


written to or read from. 


is the name of the file. 


where: 

Ln 

immediately. 
f 

the file. 
r 

expression. 
t 

expression. 
svar-l 
svar-2 


is an optional string expression. 
Svar-2 specifies how the file may 
be written to or read from. 


48 


Multi-User BASIC Instruction Manual 
Additional Commands to 16K BASIC 


Notes: 


1. Either t or svar-2 may be used to specify how 
the file may be written to or read from. If 
there is a conflict between t and svar-2, 
Svar-2 takes precedence. The value of t is 
given by the following table. 


3 exclusive write, non-exclusive read 

2 exclusive write, exclusive read 

g no writing by any user, non- 
exclusive read 

1 non-exclusive read 


The first upper-case letter in svar-2 which 
matches a letter in the following list 
determines whether the user is requesting 
permission to write or read the file, or both, 
and whether other users are to be excluded 
from the file. 


W exclusive write, non-exclusive read 

xX exclusive write, exclusive read 

N no writing by any user, non- 
exclusive read 

R non-exclusive read 


The default value of svar-2 is "WwW". 
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instruction: PROTECT file 


format: [Ln] PROTECT svar-l, svar-2 


wheres 


Ln is an optional line number. 
If Ln is included, the 


instruction is executed at run 


time. Otherwise, it is executed 
immediately. 


svar-l is the name of the file. 
svar-2 is a string expression. 


Ssvar-2 specifies which protection 
attributes the file is to have. 


Notes: 


Ay 


The file is assigned all those attributes 
corresponding to the upper-case letters from 
the following list which svar-2 contains. 


erase-protected 
write-protected 
read-protected 


aah 


If svar-2 contains the character +, then the 
attributes specified by svar-2 are added to 
those the file already has. Otherwise, they 
replace them. 


If svar-2 is the empty string (indicated by a 
pair of double quotes with nothing in 
between), then all of the attributes are 
removed from the file. 


All write-protected files are also erase- 
protected. 
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BASIC Editor 
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BASIC Editor 


CROMEMCO In-Line BASIC Editor 


commands: 


format: 


where: 
Ll 


L2 


CHANGE 
EDIT 
FIND 


command 
command Ll 
command Ll, 


command L1,L2 


is an optional line number or 
name. 


If Ll is omitted, all lines of 
the program are processed. 


If Ll is the only argument and 
there is no comma following it, 
then Ll is the only line 
processed. 


If Ll is the only argument and 
the comma is included, Ll 
through the last line in the 
program are processed by the 
command. 


is an optional line number or 
name which indicates the last 
line’ to be processed. If 
included, it must be preceded by 
Ll and a comma. 
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BASIC Editor 


Notes: 


1. 


When uSing terminals in uppercase mode, BASIC 
should be set so that it lists in uppercase by 
entering the command: 


SET 6,1 
This is because the Find command will not find 


the given string unless it agrees exactly with 
what is typed. 
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EDIT 


Edit is one of the three commands which are 
collectively called the Cromemco In-Line BASIC 
Editor. The other two are Change and Find. Edit 
lists lines of code one at a time, as specified by 
Ll and L2. Each line to be Edited is preceded by a 
dash (-) and followed on the next line by a colon 
(:) prompt. In response to the prompt, the user 
may type: : 


1. a RETURN, which leaves the line unchanged 
and displays the next line for Editing, 
or 


2. a series of spaces, which will position 
the cursor under the character which is 
to be edited. 


At this point, the user can give the 
Editor the following commands: 


a. D (Delete) - deletes the character 
above the cursor. Several deletions 
can be made on one line. 


b. I (Insert) - inserts the string 
which follows. An insertion can 
follow one or more deletions. 


Cc. K (Kill) - deletes the rest of the 
line from the current position of 
the cursor. 


Pressing RETURN causes the command line to be 
executed. The edited line is then typed out and a 
prompt is given for further changes. 


When the line has been changed to the user's 
satisfaction, a RETURN should be pressed again in 
response to the prompt for additional corrections. 
If the Editor goes on to the next line but the user 
wishes to stop editing at theis time, ESCape should 
be pressed. This will not affect any changes made 
except those of the currently displayed line. 
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FIND 


Find is another of the interactive Editor commands. 
( Find will locate all occurrences of a string within 
the set of lines specified by Ll and L2. After the 
find command is given, the Editor will prompt with: 


FIND: 


The user should then enter the string to be 

located, followed by a RETURN. If a RETURN is 

entered immediately following the prompt, the 

Editor will return control to the BASIC monitor. 

Each line containing the string will be printed out 

; with a pointer below the line indicating the 

aa occurrence of the specified string. 
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CHANGE 


The Change command will replace all occurrences of 
a string within a set of lines specified by Ll and 
L2. After the Change command is given, the Editor 
will prompt with: 


FROM: 


In response, the user should enter the string to be 
replaced followed by a RETURN. The Editor will 
then prompt with: 


TO: 


The user should respond with the replacement 
string. The Editor will then print the first line 
containing the string with a pointer below the line 
indicating the location of the string. The user 
can then input: 


dis a RETURN only to reject the change at 
that location and proceed to the next 
occurrence, 


26 the letter (C) to accept the change and 
go on, 


3. an asterisk (*) + to accept all changes 
from that point on, or 


4. ESCape to abort the process. 
Please note that for the Change and Find commands 
the desired string must be entered exactly as it is 


Listed, including upper and lower case, or the 
Editor will not be able to find it. 
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Multi-User BASIC Error Messages 
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Multi-User BASIC has several error messages in 
addition to those listed in the 16K Extended BASIC 
Instruction Manual. 


220 


222 


223 


224 


225 


The function SYS (3) 


FILE ERASE~PROTECTED —- 


FILE WRITE~PROTECTED - - 


FILE READ-PROTECTED - 


FILE BEING USED - 


TOO MANY OPEN FILES — 


runtime error which occurred. 
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An attempt was made to 
erase a file that had 
been erase-protected 
by the BASIC 
instruction PROTECT. 


An attempt was made to 
write to file that had 
been write-protected 
by the BASIC 
instruction PROTECT. 


An attempt was made to 
read a file that had 
been read-protected by 
the BASIC instruction 
PROTECT. 


An attempt was made to 
access a file that was 
being used by another 
user. 


An attempt was made to 
open more than. the 
maximum of 16 files. 
Each user is allowed 
to open up to 16 
files. 


returns the number of the last 
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Modification of Multi-User BASIC 
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Through DEBUG modifications of BOOT.COM it is 
possible to change the CDOS commands and programs 
that run upon logging on and to restrict users from 
using CDOS programs and the BASIC MORE, CHA, and 
machine level instructions. 


Customizing User Startup Command Lines 


When each user logs on, a series of commands is 
executed. These commands are contained in a 
command line which is stored in the file BOOT.COM. 
There are seven command lines in this file, one for 
each user. Each command line is up to twenty bytes 
long and consists of ASCII code. Each command line 
must be terminated with a byte of @@. This section 
may be modified to run other CDOS programs and 
commands. The DEBUG address of the command line 
for user-l is located at 312 hexadecimal. The 
command lines for other users will be found 
following that of user-l. 


The following is an example describing how to 

modify this command line. First, in CDOS we type: 
debug boot.com 

The response will be: 


DEBUG VERSION 69.89 
NEXT = 7D@09 


At the dash prompt, enter: 

dm 312 s2 
This will display two bytes from which the address 
in hexadecimal of the command line for user-l may 


determined by reversing their order: 


0312 F3 38 
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38F3 
3983 


38F3 
3983 


To display the contents of the command line, at 


the DEBUG prompt "-" type: 


dm 38£3 s20 


53 59 59 @D OD 42 41 53-28 53 54 41 52 54 55 58 
2E 53 41 56 6D O98 FF FF-FF FF FF FF FF FF FF FF 


To change the command line, at the prompt type: 


sm 38£3 
The response will be: 


38F3 38F3" 53 


On this line type in the new command line. 


SYS..BAS.STARTUP 
we SAV 6.06 06.0 eke ase as 


The 


entries should only be CDOS commands and programs. 


They should be enclosed in single quotes. 


Entries 


should be separated from one another by 9D with no 
quotes. ‘'SYS' must be followed by 8D OD unless it 
is the last program to be run in the command line. 
The last entry must be terminated by a @D and @@. 
Remember that you only have twenty bytes for this 


user. To have the command line become SYS, 
‘and STAT type on the displayed line: 


38F3 38F3" 53 "SYS" @D 
3962 3902' 58 . 


8D 


DIR, 


In the example above, a carriage return was entered 


after @@ on the 38F3 line. 


A period was entered on .- 


the 3992 line to discontinue the entry of changes. 
To display the new command line, once again type dm 


38£3 s2@. The response will be: 


53 59 59 9D OD 44 49 52-8D 53 54 41 54 OD 88 58 
2E 53 41 56 0D 99 FF FF-FF FF FF FF FF FF FF FF 


SYS..DIR.STAT..P 
eSAVe csc scsscvce 


It is acceptable to leave in characters after the 
first 08. Characters which appear after @@ will be 


ignored. 
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Up until this point, we have been discussing the 
command line for user-l only. To modify the 
command line for other users we will first need to 
determine the address of their command line. This 
may be done by adding increments of 26H to the 
address for user-l. 


User Number to be added 
2 20H 
3 49H 
4 60H 
5 88H 
6 ASH 
7 COH 


This addition may be done in DEBUG. To add 89H to 
38F3H, enter: 


h 38£3 88 
at the dash prompt. The response will be: 
3973 3773 


where the first number is the sum and the second is 
the difference. 


When all of the user command lines that have needed 
modification have been changed, at the prompt type: 


g@ 


In order to save these modifications, the new 
BOOT.COM must be SAVEd. This is done by first 
determining the length in pages. This is 
accomplished by typing: 


dir boot.com 
at the CDOS prompt. The length of the file will be 
displayed in kilobytes. This may be converted to 
pages by multiplying the number of kilobytes by 
four. To SAVE the new BOOT.COM file type: 


save boot.com # 


where # is the number of pages. 
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Restricting Access to CDOS Programs 
Users may be kept from running CDOS programs, 
suchas STAT and ASMB, and restricted to the use of 
CDOS commands, suchas DIR and BAS. This is done 
with a DEBUG modification of BOOT.COM. The byte at 
. DEBUG address 39CH contains this information. If a 
bit is set to 1, a terminal will be disallowed the 
access to CDOS programs. The following table shows 
the relationship between bits set and terminals 


disabled. 
Terminal Bit set 
1 4) 
2 1 
3 2 
4 3. 
5 4 
6 5 
7 6 


The byte at DEBUG address 3@CH in binary is 
initially 9008 9098. To disable terminals 3, 5, 
and 6 we would set bits 2, 4, and 5. The byte 
would now be @@11 9109. In hexadecimal this is 34, 
In DEBUG we would substitute memory for the byte at 
address 39CH: 


- =-sm 38c 
@30C OB 34 
030D FE . 
‘-dm 30c sl 
G30C 34 


Users may be disallowed the capability of using the 

CHA command. This is also accomplished by a DEBUG 
modification of BOOT.COM. The byte at DEBUG 
address 3@8DH contains this information. The table 
in. the previous section applies to this section 
also. The initial setting of this byte is FE 
hexadecimal which allows only user-1l to use the CHA 

. command. . 


63 


Multi~User BASIC Instruction Manual 
Modification of Multi-User BASIC 


The second use of the MORE command may be disabled 
for selected users. To restrict users to a maximum 
memory allotment of 48K, modify the byte at DEBUG 
address 38FH of BOOT.COM in the manner previously 
described. The initial setting of this byte is FE 
hexadecimal which allows only user-l the second use 
of the MORE command. 


The first use of the MORE command may also be 
disabled. Users may be restricted to a maximum 
memory allotment of 32K by a DEBUG modification of 
BOOT.COM. The byte at DEBUG address 39EH contains 
this information. This byte is initially @@ 
hexadecimal so that all users have the first use of 
the MORE command. 


ce 


Users may be disallowed the capability of using the 
KILL command. This is accomplished by modifying 
the byte at DEBUG address 319H of BOOT.COM in the 
manner previously described. The initial setting 
of this byte is FE hexadecimal so that only user-1l 
can use the KILL command. 


The use of the OUT, INP, POKE, PEEK, and USR 
functions and instructions can be restricted in a 
multi-user environment because with them a user 
could do harm to the operation of the whole system. 
On the other hand, they are powerful commands which 
may be useful in selected cases. 


Beginning at DEBUG location 314H of BOOT.COM is the 
2-byte address of the byte that will determine 
accessibility of machine level BASIC instructions. 
If this byte is C9 all users may access these BASIC 
instructions. To prohibit all users except user-l 
from using these instructions substitute @@ for C9. 


If this is done Multi-User BASIC allows only the 
user who has control of the system diskette to 
write programs which use these commands. However, 
any user can LOAD and run a program which has been 
previously SAVEd, even one which includes these 
commands. 
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If the user of terminal-1 wishes to write a program 
including these commands, the previously mentioned 
DEBUG address change should have been made and 
"LOCK" must be entered as the user name when the 
system is brought up. MThis prevents additional 
users from logging on. After the program is 
written and SAVEd, the user can LOGOFF and log on 
again by pressing the RETURN key several times. 
Other users can then log on the system. 


Disk Drive Configuration 


The Multi-User system can accommodate up to four 
floppy disk drives. The file BOOT.COM contains a 
disk table which specifies the drive types. This 
table is located at DEBUG address 34H. The 
Standard system is shipped configured for two dual 
8" floppies (four drives in all). The values in 
the disk table for this are: 


DEBUG Address Contents Disk Drive 


304 B6H A 
3905 00H A 
386 B2H B 
397 80H B 
398 B6H Cc 
309 86H Cc 
360A B2H D 
3 0B 90H D 


To use a 5" floppy disk drive, change the contents 
of the first byte for that drive to 28H. If the 
system does not include a particular disk drive, 
change the contents to 9G. For example, if drive C 
is to be a 5" floppy and there is no drive D, DEBUG 
location 388H should contain 28 and location 3@AH 
should contain 9@. 
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Cards included in the basic two-user system are: 


ZPU processor card 

4FDC Disk Controller 
64KZ R/W Memory 

TU-ART Digital Interface 
PRI Printer Interface 


BRM 


The 64KZ is the ideal memory card for use in a 
Cromemco Multi-User BASIC system. Upon logging on, 
each user is assigned a job number. This job 
number is is one greater than the memory bank 
number in which the job runs, i.e. job-1l runs in 
bank-@. Each user will be allocated 32K of 
read/write memory addressed at location @O@@0H. 
16KZs may also be used and each user may then be 
allocated either 16K or 32 K starting at address 
OBOOH. The operating system requires 64K of 
read/write memory. Of the 64K, the 32K from 
address 8@0@0H to FFFFH is assigned to all memory 
banks, @ - 7; this area contains the BASIC 
interpreter and part of the operating system. The 
remaining 32K, addressed from @900H to 7FFFH, is 
assigned to memory bank 7 only. This memory area 
currently contains most of the system disk and 
terminal I/O routines. 


System RAM Cards 
Either half of two 64KZ cards or four l16KZ RAM 
cards are required for the operating system and 
BASIC. These are configured as follows: 


64KZ RAM Cards 


64KZ Actual Address Reset 

Card Address Switches Switches Bank Switches 

2 OOOOH Al15-B @ Reset B off 7 on, others off 
1 8809H A15-B 1 Reset B off all on 
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16KZ RAM Cards 


Address 
Actual Switches 
Address 15 14 Bank Switches 
Q990H off off @- 6 off, 7 on 
4900H off on @ ~ 6 off, 7 on 
8809H on off all on 
COOOH on on @ off, 1-7 on 


The C@@@H card is the 16KZ card that has been 
jumpered to be turned off on reset. 


User RAM Cards 


Each user must have either one half of a 64KZ or a 
16KZ RAM card at address @ (address switch 15 off, 
14 off). The actual address for each memory card 
is @0@@H. If 16KZ2 cards are used, the user may 
also have a second 16KZ card at address 4890H 
(switch 15 off, 14 on). The bank settings for RAM 
cards are given by the following table. 


64KZ Cards 
64KZ Address 
User Card Switches Bank Switches 
1 1 A15-A off @ on, all others off 
2 2 A15-A off 1 on, all others off 
3 3 A15-A off 2 on, all others off 
4 3 A1l5-B off 3 on, all others off 
5 4 A1l5-A off 4 on, all others off 
6 4 A15-B off 5 on, all others off 
7 5 A15-A off 6 on, all others off 


The reset switch for user 1 should be set in. All 
other reset switches should be set out. 


16KZ Cards 


s 


‘User Bank Switches 


) 

1 

2 on, all others off 
3 on, all others off 
4 on, all others off 
5 
6 


on, all others off 
on, all others off 
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4FDC Disk Controller Card 


The Cromemco 4FDC disk controller interfaces 5" and 
8" floppy disk to the S-188 bus used in Cromemco 
computers. One of the features of the 4FDC is a 
serial I/O channel with software selectable baud 
rates ranging from 11% baud to 76,888 baud. The 
4FDC also has a 1K resident 2788 ROM pre-programmed 
with Cromemco's RDOS ROM-resident Disk Operating 
System. 


Set switch 1 off, switches 2, 3, and 4 on to 
prepare the card for use with Multi-User CDOS and 
BASIC. 


The 4FDC services Terminal-l1 through connector J4. 
TU-ART Digital Interface Cards 


A Multi-User System must include from one to three 
TU-ARTS. 


Each TU-ART can service two terminals. The even- 
numbered terminal is serviced through connector J4 
(SERIAL A) and the odd-numbered terminal through J5 
(SERIAL B). 


TU-ART Switches 


TU-ART Terminals 3 4 5 6 78 9 18 
1 2 & 3 G19 9 18148 
2 4&5 @1i1 8 l11li1&6 
3 6 & 7 6601 1661 


Note that for TU-ART switches, "9" indicates that 
the switch should be on. 


Switches 1 and 2 on all TU-ARTs should be off. 


If the system includes a Cromemco 3783 or 3779, 
printer it should be connected to TU-ART 1 through 
connector J3 (PARALLEL 8B). The standard PRI non- 
interrupt interface card should not be used in a 
multi-user system. 
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Interrupt Priority Cable 


Use the Priority Cable to connect Priority OUT of 
the 4FPDC (connector Jl, pin 3) to Priority IN of 
TU-ART 1 (connector Jl). If the system includes 
more than a single TU-ART, connect Priority OUT of 
TU-ART 1 (J1) to Priority IN of TU-ART 2 (Jl). I€£ 
the system includes a third TU-ART, connect 
Priority OUT of TU-ART 2 (J1) to Priority IN of 
TU-ART 3 (J1). 


Special Configuration 


In the standard configuration, all users share 
memory at address 8@@@H in which BASIC can be 
loaded. In order to allow more than one user to 
obtain 48K of memory in which to run CDOS programs, 
some of the memory banks should have private memory 
at 8@00H. This requires the use of some 16KZ cards 
since all banks must share memory addressed at 
COOGH. For example, with the following seven-user 
memory configuration: 


Address Bank(s) Jobs 


16KZ CQOGH 


g 7 11 (system card) 
16KZ 8800H Q,1,2 1273 
“16KZ 88086H ' 
16KZ 89080H 
16KZ 8809H 
‘16KZ 8800H 


1/2-64KZ OOOOH 
1/2-64KZ 8906H 
1/2-64KZ OOOOH 
1/2~-64KZ 8@806GH 
1/2-64KZ OOOOH 
1/2-64KZ 889GH 
1/2-64K2 6000H 
1/2-64KZ 8800H 


a 
1 
4 
5 
6 
7 
all (system card) 
1 
2 
3 
4 
5 
6 
7 


AuUPWNHRAUADNUPWE | 


four banks, 3 -—- 6, are private banks since each 
shares memory at 898@H with no other banks. This 
means that as many as four users may each obtain 
48K of memory by using the MORE command. At the 
same time, three other users could run in banks @ - 

2 with 32K of memory apiece since these banks 
share memory at 8999H. Each of these three users 
could run either a CDOS program in 32K of memory or 
a BASIC program which uses up to 32K of memory. If 
BASIC is loaded, it resides at. 800@H. 
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